home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / daemons / dns / bind-4.9 / bind-4 / usr / man / man1 / dnsquery.1 < prev    next >
Encoding:
Text File  |  1995-08-04  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DNSQUERY(1)                                           DNSQUERY(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        dnsquery - query domain name servers using resolver
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ddnnssqquueerryy  [-n  _n_a_m_e_s_e_r_v_e_r_] [-t _t_y_p_e_] [-c _c_l_a_s_s_] [-r _r_e_t_r_y_]
  12.        [-p _r_e_t_r_y _p_e_r_i_o_d_] [-d] [-s] [-v] host
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        The _d_n_s_q_u_e_r_y program is a general interface to nameservers
  16.        via  BIND  resolver  library  calls.  The program supports
  17.        queries to the nameserver with an opcode of  QUERY.   This
  18.        program  is  intended to be a replacement or supplement to
  19.        programs like nstest, nsquery and nslookup.  All arguments
  20.        except   for   _h_o_s_t  and  _n_s  are  treated  without  case-
  21.        sensitivity.
  22.  
  23. OOPPTTIIOONNSS
  24.        --nn        The nameserver to be used in the  query.   Name-
  25.                  servers  can appear as either Internet addresses
  26.                  of the form w.x.y.z  or  can  appear  as  domain
  27.                  names.      (default:     as     specified    in
  28.                  /etc/resolv.conf)
  29.  
  30.        --tt        The type of resource record of interest.   Types
  31.                  include:
  32.  
  33.                       A         address
  34.                       NS        nameserver
  35.                       CNAME     canonical name
  36.                       PTR       domain name pointer
  37.                       SOA       start of authority
  38.                       WKS       well-known service
  39.                       HINFO     host information
  40.                       MINFO     mailbox information
  41.                       MX        mail exchange
  42.                       RP        responsible person
  43.                       MG        mail group member
  44.                       AFSDB
  45.                                 DCE or AFS server
  46.                       ANY       wildcard
  47.  
  48.                  Note that any case may be used.  (default:  ANY)
  49.  
  50.        --cc        The  class  of  resource  records  of  interest.
  51.                  Classes include:
  52.  
  53.                            IN        Internet
  54.                            HS        Hesiod
  55.                            CHAOS     Chaos
  56.                            ANY       wildcard
  57.  
  58.                  Note that any case may be used.  (default:  IN)
  59.  
  60.        --rr        The  number  of times to retry if the nameserver
  61.  
  62.  
  63.  
  64.                           10 March 1990                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DNSQUERY(1)                                           DNSQUERY(1)
  71.  
  72.  
  73.                  is not responding.  (default:  4)
  74.  
  75.        --pp        Period to wait  before  timing  out.   (default:
  76.                  RES_TIMEOUT)   _o_p_t_i_o_n_s  field.   (default:   any
  77.                  answer)
  78.  
  79.        --dd        Turn on debugging.  This sets the RES_DEBUG  bit
  80.                  of  the resolver's _o_p_t_i_o_n_s field.  (default:  no
  81.                  debugging)
  82.  
  83.        --ss        Use a _s_t_r_e_a_m rather than a packet.  This uses  a
  84.                  TCP stream connection with the nameserver rather
  85.                  than a UDP datagram.  This  sets  the  RES_USEVC
  86.                  bit  of the resolver's _o_p_t_i_o_n_s field.  (default:
  87.                  UDP)
  88.  
  89.        --vv        Synonym for the 's' flag.
  90.  
  91.        hhoosstt      The name of the host (or domain) of interest.
  92.  
  93. FFIILLEESS
  94.        /etc/resolv.conf    to get the default ns and search lists
  95.        <arpa/nameser.h>    list of usable RR types and classes
  96.        <resolv.h>          list of resolver flags
  97.  
  98. SSEEEE AALLSSOO
  99.        nslookup(8), nstest(1), nsquery(1), named(8), resolver(5)
  100.  
  101. DDIIAAGGNNOOSSTTIICCSS
  102.        If  the  resolver  fails to answer the query and debugging
  103.        has not been turned on, _d_n_s_q_u_e_r_y will simply print a  mes-
  104.        sage like:
  105.  
  106.        Query failed (rc = 1) : Unknown host
  107.  
  108.        The value of the return code is supplied by h_errno.
  109.  
  110. BBUUGGSS
  111.        Queries  of  a  class  other  than IN can have interesting
  112.        results since ordinarily a nameserver only has a  list  of
  113.        root nameservers for class IN resource records.
  114.  
  115.        Query uses a call to inet_addr() to determine if the argu-
  116.        ment for the '-n' option  is  a  valid  Internet  address.
  117.        Unfortunately,  inet_addr()  seems to cause a segmentation
  118.        fault with some (bad) addresses (e.g. 1.2.3.4.5).
  119.  
  120. AAUUTTHHOORR
  121.        Bryan Beecher
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                           10 March 1990                         2
  131.  
  132.  
  133.